home *** CD-ROM | disk | FTP | other *** search
/ MacHack 1996 / MacHack 1996.toast / Hacks / Hacks ’95 / ProcessBar™ / Code / Sources / ScriptableFinder.c < prev    next >
Encoding:
Text File  |  1995-06-24  |  31.2 KB  |  761 lines  |  [TEXT/MMCC]
  1. // File by Leonard Rosenthol
  2.  
  3. #include <icons.h>
  4. #include <AppleEvents.h>
  5. #include <AERegistry.h>
  6. #include "FinderRegistry.h"
  7. #include "ScriptableFinder.h"
  8.  
  9. static    OSErr    convertfahtoAElist(FSSpecArrayHandle fah, AEDescList *selectionlist)
  10.  
  11. /*    A routine to convert the data contained within the passed FSSpecArrayHandle into an AEDescList
  12.     which can be passed as a parameter inside an Apple Event.
  13.  
  14.      Input:    fah - source FSSpecArrayHandle.
  15.      Input:    *selectionlist - result AEDescList (must be pre-created) passed by reference.
  16.  
  17.     Output:    error code that occured. */
  18.  
  19. {
  20.     short    result;
  21.  
  22.     result = noErr;
  23.     if (fah != nil) 
  24.     {
  25.         short    i, maxfah, count;
  26.  
  27.         count = 0;
  28.         maxfah = (GetHandleSize((Handle)fah) / sizeof(FSSpec));
  29.         for (i = 0; i < maxfah; i++)
  30.             if (result == noErr) 
  31.             {
  32.                 count++;
  33.                 if ((result = AEPutPtr(selectionlist, count, typeFSS, &(*fah)[i], sizeof(FSSpec))) != noErr) 
  34.                     count--;
  35.             }
  36.     }
  37.     return(result);
  38. }
  39.  
  40. OSErr    AddToFSSpecArrayHandle (FSSpec *f, FSSpecArrayHandle fah)
  41.  
  42. {
  43.     OSErr    result;
  44.     long    l;
  45.  
  46.     l = InlineGetHandleSize((Handle)fah);
  47.     SetHandleSize((Handle)fah, l + sizeof(FSSpec));
  48.     result = MemError();
  49.     if (result == noErr) 
  50.         BlockMoveData(f, (Ptr)((long)*fah + l), sizeof(FSSpec));
  51.     return(result);
  52. }
  53.  
  54. OSErr    GetFinderProcess (ProcessSerialNumber *finderpsn, Boolean shortcut)
  55.  
  56. /*    A routine to determine the process serial number of the Finder. It returns the result as a
  57.     parameter passed by reference. It also has a Boolean parameter which specifies whether or not
  58.     the returned process serial number will represent the Finder process serial number as
  59.     "kCurrentProcess" if it is the current process to allow a shortcut of the _GetNextEvent call
  60.     dependencies of processing an AppleEvent.
  61.  
  62.      Input:    shortcut - allow "kCurrentProcess" to be used if we are in the current process.
  63.      Input:    *finderpsn - result ProcessSerialNumber passed by reference.
  64.  
  65.     Output:    error code that occured. */
  66.  
  67. {
  68.     Boolean                result;
  69.     ProcessSerialNumber    psn, currentpsn;
  70.     ProcessInfoRec        pir;
  71.  
  72.     psn.highLongOfPSN = 0;
  73.     psn.lowLongOfPSN = kNoProcess;
  74.     pir.processInfoLength = sizeof(ProcessInfoRec);
  75.     pir.processName = nil;            // don't want these bits of information
  76.     pir.processAppSpec = nil;
  77.     while (GetNextProcess(&psn) == noErr) 
  78.         if (GetProcessInformation(&psn, &pir) == noErr) 
  79.             if ((pir.processType == kFinderType) && (pir.processSignature == kFinderSignature)) 
  80.             {
  81.                 if (shortcut && (GetCurrentProcess(¤tpsn) == noErr) && 
  82.                     (SameProcess(¤tpsn, &psn, &result) == noErr) && result) 
  83.                 {            // use the current process to shortcut the event dispatching
  84.                     finderpsn->highLongOfPSN = 0;
  85.                     finderpsn->lowLongOfPSN = kCurrentProcess;
  86.                 }
  87.                 else
  88.                     *finderpsn = psn;            // found the Finder's psn
  89.                 return(noErr);            // got the process serial number
  90.             }
  91.     return(procNotFound);            // got an error - not found
  92. }
  93.  
  94. Boolean    IsRelativeProcessSerialNumber (ProcessSerialNumber *psn)
  95.  
  96. /*    A simple routine which determines whether the process serial number given is a relative one.
  97.     This means that it isn't a number which refers to the process outright but rather refers to the
  98.     process because it's current.
  99.  
  100.      Input: psn - the ProcessSerialNumber to check.
  101.  
  102.     Output: Boolean result. */
  103.  
  104. {
  105.     return((psn->highLongOfPSN == 0) && (psn->lowLongOfPSN == kCurrentProcess));
  106. }
  107.  
  108. OSErr    GetScriptableFinderSelection (FSSpecArrayHandle *fah, Boolean usesystemmode)
  109.  
  110. /*    A routine to get the Finder's selection using the GetData Apple Event. It tries it's best to get
  111.     the result immediately and resorts to allowing the shortcut in the AESend routine where the
  112.     event is sent to the current process specified by "kCurrentProcess" in the ProcessSerialNumber.
  113.  
  114.      Input:    *fah - result FSSpecArrayHandle passed by reference. Nil if no items selected.
  115.      Input:    usesystemmode - a Boolean which determines whether the system's PPC port will be used.
  116.  
  117.     Output:    error code that occured. */
  118.  
  119. {
  120.     short                errnum;
  121.     Boolean                fiddlewithA5;            // See below for the usage of the A5 variables
  122.     long                saveA5;
  123.     OSType                selectiondescriptor, resultdescriptor;
  124.     ProcessSerialNumber    targetpsn;
  125.     AEDesc                targetaddress, selectiondesc, nulldesc, directdesc, requestdesc, listdesc;
  126.     AppleEvent            myae, myreply;
  127.  
  128.     *fah = nil;            // make sure we have a valid empty result
  129.     selectiondescriptor = pSelection;
  130.     resultdescriptor = typeFSS;
  131.     if (GetFinderProcess(&targetpsn, kRelativeFinderPSN) == noErr) 
  132.     {
  133.         if (usesystemmode) 
  134.             TurnSystemModeOn();            // you really DON'T want to do this
  135.     
  136. /*    Here's a good problem. If we shortcut the Apple Event processing mechanism by using the relative
  137.     kCurrentProcess in the process serial number to get to the Finder's 'Get Data' routine this
  138.     works fine if the A5 register is that of the Finder. However, Magic Menu calls this routine from
  139.     a patch within _MenuKey or _MenuSelect and the Process Manager patches over these routines. It
  140.     puts its own A5 in but doesn't modify the low-memory global. So... just to be sure that we've
  141.     got the correct A5 we'll restore the A5 world if we're using the relative process serial number.
  142.     Otherwise the Apple Event is sent via the Event Manager and the A5 register will be correct. */
  143.  
  144.         fiddlewithA5 = IsRelativeProcessSerialNumber(&targetpsn);
  145.         if (fiddlewithA5) 
  146.             saveA5 = SetCurrentA5();
  147.  
  148. /*    The following if statement is the guts of the GetScriptableFinderSelection routine. It
  149.     composes the AppleEvent and fills in all the correct parameters and options. Then it calls
  150.     the Finder to get the information and extracts the returned data from the descriptor list.
  151.     It puts the items in an FSSpecArrayHandle. If an error occurs it just returns nil. Note that
  152.     this routine uses an assignment followed by a comparison which although not good logic allows
  153.     this routine to be compressed into a single if statement linked with terminating and comparisons
  154.     whilst collecting the error number that occurred. */
  155.  
  156.         if (((errnum = AECreateDesc(typeProcessSerialNumber, &targetpsn, sizeof(targetpsn), &targetaddress)) == noErr) && 
  157.             ((errnum = AECreateAppleEvent(kAECoreSuite, kAEGetData, &targetaddress, kAutoGenerateReturnID, kAnyTransactionID, &myae)) == noErr) && 
  158.             ((errnum = AEDisposeDesc(&targetaddress)) == noErr) && 
  159.             ((errnum = AECreateDesc(typeType, &selectiondescriptor, sizeof(selectiondescriptor), &selectiondesc)) == noErr) && 
  160.             ((errnum = AECreateDesc(typeNull, nil, 0, &nulldesc)) == noErr) && 
  161.             ((errnum = CreateObjSpecifier(cProperty, &nulldesc, formPropertyID, &selectiondesc, TRUE, &directdesc)) == noErr) && 
  162.             ((errnum = AEPutParamDesc(&myae, keyDirectObject, &directdesc)) == noErr) && 
  163.             ((errnum = AEDisposeDesc(&selectiondesc)) == noErr) && 
  164.             ((errnum = AEDisposeDesc(&nulldesc)) == noErr) && 
  165.             ((errnum = AEDisposeDesc(&directdesc)) == noErr) && 
  166.             ((errnum = AECreateDesc(typeType, &resultdescriptor, sizeof(resultdescriptor), &selectiondesc)) == noErr) && 
  167.             ((errnum = AECoerceDesc(&selectiondesc, typeAEList, &requestdesc)) == noErr) && 
  168.             ((errnum = AEDisposeDesc(&selectiondesc)) == noErr) && 
  169.             ((errnum = AEPutParamDesc(&myae, keyAERequestedType, &requestdesc)) == noErr) && 
  170.             ((errnum = AEDisposeDesc(&requestdesc)) == noErr) && 
  171.             ((errnum = AESend(&myae, &myreply, kAEWaitReply, kAENeverInteract, kAEDefaultTimeout, nil, nil)) == noErr) && 
  172.             ((errnum = AEGetParamDesc(&myreply, keyAEResult, typeAEList, &listdesc)) == noErr) && 
  173.             ((errnum = AEDisposeDesc(&myreply)) == noErr) && 
  174.             ((errnum = AEDisposeDesc(&myae)) == noErr)) 
  175.         {            // Whew! We passed the test. Do we get a cookie now?
  176.             short                i;
  177.             long                count;
  178.             AEKeyword            returnedkeyword;
  179.             AEDesc                resultdesc;
  180.  
  181. //    Convert result AEDesc list of FSSpecs to our own internal FSSpecArrayHandle
  182.  
  183.             *fah = (FSSpecArrayHandle)NewHandle(0);
  184.             if ((errnum = AECountItems(&listdesc, &count)) == noErr) 
  185.                 for (i = 1; i <= count; i++)
  186.                     if ((errnum == noErr) && (errnum = AEGetNthDesc(&listdesc, i, typeFSS, &returnedkeyword, &resultdesc)) == noErr) 
  187.                     {
  188.                         HLock(resultdesc.dataHandle);
  189.                         errnum = AddToFSSpecArrayHandle(*(FSSpecHandle)resultdesc.dataHandle, *fah);
  190.                         HUnlock(resultdesc.dataHandle);
  191.                         if (errnum == noErr) 
  192.                             errnum = AEDisposeDesc(&resultdesc);
  193.                     }
  194.             if (errnum == noErr) 
  195.                 errnum = AEDisposeDesc(&listdesc);
  196.         }
  197.         if (fiddlewithA5) 
  198.             SetA5(saveA5);            // fix it up for crying out loud!
  199.         if (usesystemmode) 
  200.             TurnSystemModeOff();            // we really DIDN'T want to do this
  201.     }
  202.     return(errnum);            // the result
  203. }
  204.  
  205. OSErr    SetScriptableFinderSelection (FSSpecArrayHandle fah, Boolean usesystemmode, 
  206.             AESendMode sendmode)
  207.  
  208. /*    A routine to set the Finder's selection using the GetData Apple Event. It tries it's best to get
  209.     the result immediately and resorts to allowing the shortcut in the AESend routine where the
  210.     event is sent to the current process specified by "kCurrentProcess" in the ProcessSerialNumber.
  211.  
  212.      Input:    fah - FSSpecArrayHandle which contains the items to select. Nil if no selection.
  213.      Input:    usesystemmode - a Boolean which determines whether the system's PPC port will be used.
  214.      Input: sendmode - which mode to send the Apple Event to the Finder.
  215.  
  216.     Output:    error code that occured. */
  217.  
  218. {
  219.     short                errnum;
  220.     Boolean                fiddlewithA5;            // See below for the usage of the A5 variables
  221.     long                saveA5;
  222.     OSType                selectiondescriptor, resultdescriptor;
  223.     ProcessSerialNumber    targetpsn;
  224.     AEDesc                targetaddress, selectiondesc, nulldesc, directdesc;
  225.     AEDescList            selectionlist;
  226.     AppleEvent            myae, myreply;
  227.  
  228.     selectiondescriptor = pSelection;
  229.     resultdescriptor = typeFSS;
  230.     if (GetFinderProcess(&targetpsn, kRelativeFinderPSN) == noErr) 
  231.     {
  232.         if (usesystemmode) 
  233.             TurnSystemModeOn();            // you really DON'T want to do this
  234.         fiddlewithA5 = IsRelativeProcessSerialNumber(&targetpsn);
  235.         if (fiddlewithA5) 
  236.             saveA5 = SetCurrentA5();
  237.         if (((errnum = AECreateDesc(typeProcessSerialNumber, &targetpsn, sizeof(targetpsn), &targetaddress)) == noErr) && 
  238.             ((errnum = AECreateAppleEvent(kAECoreSuite, kAESetData, &targetaddress, kAutoGenerateReturnID, kAnyTransactionID, &myae)) == noErr) && 
  239.             ((errnum = AEDisposeDesc(&targetaddress)) == noErr) && 
  240.             ((errnum = AECreateDesc(typeType, &selectiondescriptor, sizeof(selectiondescriptor), &selectiondesc)) == noErr) && 
  241.             ((errnum = AECreateDesc(typeNull, nil, 0, &nulldesc)) == noErr) && 
  242.             ((errnum = CreateObjSpecifier(cProperty, &nulldesc, formPropertyID, &selectiondesc, TRUE, &directdesc)) == noErr) && 
  243.             ((errnum = AEPutParamDesc(&myae, keyDirectObject, &directdesc)) == noErr) && 
  244.             ((errnum = AEDisposeDesc(&selectiondesc)) == noErr) && 
  245.             ((errnum = AEDisposeDesc(&nulldesc)) == noErr) && 
  246.             ((errnum = AEDisposeDesc(&directdesc)) == noErr) && 
  247.             ((errnum = AECreateList(nil, 0, FALSE, &selectionlist)) == noErr) && 
  248.             ((errnum = convertfahtoAElist(fah, &selectionlist)) == noErr) && 
  249.             ((errnum = AEPutParamDesc(&myae, keyAEData, &selectionlist)) == noErr) && 
  250.             ((errnum = AEDisposeDesc(&selectionlist)) == noErr) && 
  251.             ((errnum = AESend(&myae, &myreply, sendmode, kAENeverInteract, kAEDefaultTimeout, nil, nil)) == noErr) && 
  252.             ((errnum = AEDisposeDesc(&myreply)) == noErr)) 
  253.             errnum = AEDisposeDesc(&myae);
  254.         if (fiddlewithA5) 
  255.             SetA5(saveA5);            // fix it up for crying out loud!
  256.         if (usesystemmode) 
  257.             TurnSystemModeOff();            // we really DIDN'T want to do this
  258.     }
  259.     return(errnum);            // the result
  260. }
  261.  
  262. OSErr    RevealScriptableFinderSelection (FSSpecArrayHandle fah, Boolean usesystemmode, 
  263.             AESendMode sendmode)
  264.  
  265. /*    A routine to reveal the contents of a given FSSpecArrayHandle using the new kAEMakeObjectVisible
  266.     Apple Event understood by the scriptable Finder. This event is better than the old 'reveal'
  267.     event as the old event doesn't deselect any previously selected items (and therefore is to be
  268.     considered buggy).
  269.  
  270.      Input:    fah - FSSpecArrayHandle which contains the items to reveal. Nil if nothing to reveal.
  271.      Input:    usesystemmode - a Boolean which determines whether the system's PPC port will be used.
  272.      Input: sendmode - which mode to send the Apple Event to the Finder.
  273.  
  274.     Output:    error code that occured. */
  275.  
  276. {
  277.     short                errnum;
  278.     Boolean                fiddlewithA5;            // See below for the usage of the A5 variables
  279.     long                saveA5;
  280.     ProcessSerialNumber    targetpsn;
  281.     AEDesc                targetaddress;
  282.     AEDescList            selectionlist;
  283.     AppleEvent            myae, myreply;
  284.  
  285.     if (GetFinderProcess(&targetpsn, kRelativeFinderPSN) == noErr) 
  286.     {
  287.         if (usesystemmode) 
  288.             TurnSystemModeOn();            // you really DON'T want to do this
  289.         fiddlewithA5 = IsRelativeProcessSerialNumber(&targetpsn);
  290.         if (fiddlewithA5) 
  291.             saveA5 = SetCurrentA5();
  292.         if (((errnum = AECreateDesc(typeProcessSerialNumber, &targetpsn, sizeof(targetpsn), &targetaddress)) == noErr) && 
  293.             ((errnum = AECreateAppleEvent(kAEMiscStandards, kAEMakeObjectsVisible, &targetaddress, kAutoGenerateReturnID, kAnyTransactionID, &myae)) == noErr) && 
  294.             ((errnum = AEDisposeDesc(&targetaddress)) == noErr) && 
  295.             ((errnum = AECreateList(nil, 0, FALSE, &selectionlist)) == noErr) && 
  296.             ((errnum = convertfahtoAElist(fah, &selectionlist)) == noErr) && 
  297.             ((errnum = AEPutParamDesc(&myae, keyDirectObject, &selectionlist)) == noErr) && 
  298.             ((errnum = AEDisposeDesc(&selectionlist)) == noErr) && 
  299.             ((errnum = AESend(&myae, &myreply, sendmode, kAENeverInteract, kAEDefaultTimeout, nil, nil)) == noErr) && 
  300.             ((errnum = AEDisposeDesc(&myreply)) == noErr)) 
  301.             errnum = AEDisposeDesc(&myae);
  302.         if (fiddlewithA5) 
  303.             SetA5(saveA5);            // fix it up for crying out loud!
  304.         if (usesystemmode) 
  305.             TurnSystemModeOff();            // we really DIDN'T want to do this
  306.     }
  307.     return(errnum);            // the result
  308. }
  309.  
  310. OSErr    OpenScriptableFinderSelection (FSSpecArrayHandle fah, Boolean usesystemmode, 
  311.             AESendMode sendmode, FSSpec *usingf)
  312.  
  313. /*    A routine to open the items in a given FSSpecArrayHandle using the specified FSSpec.
  314.  
  315.      Input:    fah - FSSpecArrayHandle which contains the items to open. Nil if nothing to open.
  316.      Input:    usesystemmode - a Boolean which determines whether the system's PPC port will be used.
  317.      Input: sendmode - which mode to send the Apple Event to the Finder.
  318.      Input: *usingf - the optional FSSpec which is designated to open the items.
  319.  
  320.     Output:    error code that occured. */
  321.  
  322. {
  323.     short                errnum;
  324.     Boolean                fiddlewithA5;            // See below for the usage of the A5 variables
  325.     long                saveA5;
  326.     ProcessSerialNumber    targetpsn;
  327.     AEDesc                targetaddress;
  328.     AEDescList            selectionlist;
  329.     AppleEvent            myae, myreply;
  330.  
  331.     if (GetFinderProcess(&targetpsn, kRelativeFinderPSN) == noErr) 
  332.     {
  333.         if (usesystemmode) 
  334.             TurnSystemModeOn();            // you really DON'T want to do this
  335.         fiddlewithA5 = IsRelativeProcessSerialNumber(&targetpsn);
  336.         if (fiddlewithA5) 
  337.             saveA5 = SetCurrentA5();
  338.         if (((errnum = AECreateDesc(typeProcessSerialNumber, &targetpsn, sizeof(targetpsn), &targetaddress)) == noErr) && 
  339.             ((errnum = AECreateAppleEvent(kCoreEventClass, kAEOpenDocuments, &targetaddress, kAutoGenerateReturnID, kAnyTransactionID, &myae)) == noErr) && 
  340.             ((errnum = AEDisposeDesc(&targetaddress)) == noErr) && 
  341.             ((errnum = AECreateList(nil, 0, FALSE, &selectionlist)) == noErr) && 
  342.             ((errnum = convertfahtoAElist(fah, &selectionlist)) == noErr) && 
  343.             ((errnum = AEPutParamDesc(&myae, keyDirectObject, &selectionlist)) == noErr) && 
  344.             ((errnum = AEDisposeDesc(&selectionlist)) == noErr)) 
  345.             {
  346.                 if (usingf != nil) 
  347.                 {            // add the using parameter
  348.                     AEDesc    usingdesc;
  349.  
  350.                     if (((errnum = AECreateDesc(typeFSS, usingf, sizeof(FSSpec), &usingdesc)) == noErr) && 
  351.                         ((errnum = AEPutParamDesc(&myae, keyAEUsing, &usingdesc)) == noErr)) 
  352.                         errnum = AEDisposeDesc(&usingdesc);
  353.                 }
  354.                 if ((errnum == noErr) && 
  355.                     ((errnum = AESend(&myae, &myreply, sendmode, kAENeverInteract, kAEDefaultTimeout, nil, nil)) == noErr) && 
  356.                     ((errnum = AEDisposeDesc(&myreply)) == noErr)) 
  357.                     errnum = AEDisposeDesc(&myae);
  358.             }
  359.         if (fiddlewithA5) 
  360.             SetA5(saveA5);            // fix it up for crying out loud!
  361.         if (usesystemmode) 
  362.             TurnSystemModeOff();            // we really DIDN'T want to do this
  363.     }
  364.     return(errnum);            // the result
  365. }
  366.  
  367. OSErr    PrintScriptableFinderSelection (FSSpecArrayHandle fah, Boolean usesystemmode, 
  368.             AESendMode sendmode)
  369.  
  370. /*    A routine to print the items in a given FSSpecArrayHandle.
  371.  
  372.      Input:    fah - FSSpecArrayHandle which contains the items to open. Nil if nothing to open.
  373.      Input:    usesystemmode - a Boolean which determines whether the system's PPC port will be used.
  374.      Input: sendmode - which mode to send the Apple Event to the Finder.
  375.  
  376.     Output:    error code that occured. */
  377.  
  378. {
  379.     short                errnum;
  380.     Boolean                fiddlewithA5;            // See below for the usage of the A5 variables
  381.     long                saveA5;
  382.     ProcessSerialNumber    targetpsn;
  383.     AEDesc                targetaddress;
  384.     AEDescList            selectionlist;
  385.     AppleEvent            myae, myreply;
  386.  
  387.     if (GetFinderProcess(&targetpsn, kRelativeFinderPSN) == noErr) 
  388.     {
  389.         if (usesystemmode) 
  390.             TurnSystemModeOn();            // you really DON'T want to do this
  391.         fiddlewithA5 = IsRelativeProcessSerialNumber(&targetpsn);
  392.         if (fiddlewithA5) 
  393.             saveA5 = SetCurrentA5();
  394.         if (((errnum = AECreateDesc(typeProcessSerialNumber, &targetpsn, sizeof(targetpsn), &targetaddress)) == noErr) && 
  395.             ((errnum = AECreateAppleEvent(kCoreEventClass, kAEPrintDocuments, &targetaddress, kAutoGenerateReturnID, kAnyTransactionID, &myae)) == noErr) && 
  396.             ((errnum = AEDisposeDesc(&targetaddress)) == noErr) && 
  397.             ((errnum = AECreateList(nil, 0, FALSE, &selectionlist)) == noErr) && 
  398.             ((errnum = convertfahtoAElist(fah, &selectionlist)) == noErr) && 
  399.             ((errnum = AEPutParamDesc(&myae, keyDirectObject, &selectionlist)) == noErr) && 
  400.             ((errnum = AEDisposeDesc(&selectionlist)) == noErr) && 
  401.             ((errnum = AESend(&myae, &myreply, sendmode, kAENeverInteract, kAEDefaultTimeout, nil, nil)) == noErr) && 
  402.             ((errnum = AEDisposeDesc(&myreply)) == noErr)) 
  403.             errnum = AEDisposeDesc(&myae);
  404.         if (fiddlewithA5) 
  405.             SetA5(saveA5);            // fix it up for crying out loud!
  406.         if (usesystemmode) 
  407.             TurnSystemModeOff();            // we really DIDN'T want to do this
  408.     }
  409.     return(errnum);            // the result
  410. }
  411.  
  412. OSErr    UpdateScriptableFinderContainer (FSSpec *f, Boolean usesystemmode, AESendMode sendmode)
  413.  
  414. /*    A routine to update the contents of a Finder window immediately. The Finder normally updates
  415.     any changes it discovers in modification date of a folder by scanning every 5-10 seconds in idle
  416.     time. Sometimes this delay can be somewhat disconcerting for a Macintosh user who expects an
  417.     icon to appear instantly. To circumvent this you should send the Finder an update event
  418.     specifying which container to update.
  419.  
  420.      Input:    *f - The FSSpec of the folder to be updated.
  421.      Input:    usesystemmode - a Boolean which determines whether the system's PPC port will be used.
  422.      Input: sendmode - which mode to send the Apple Event to the Finder.
  423.  
  424.     Output:    error code that occured. */
  425.  
  426. {
  427.     short                errnum;
  428.     Boolean                fiddlewithA5;            // See below for the usage of the A5 variables
  429.     long                saveA5;
  430.     ProcessSerialNumber    targetpsn;
  431.     AEDesc                targetaddress, updatedesc;
  432.     AppleEvent            myae, myreply;
  433.  
  434.     if (GetFinderProcess(&targetpsn, kRelativeFinderPSN) == noErr) 
  435.     {
  436.         if (usesystemmode) 
  437.             TurnSystemModeOn();            // you really DON'T want to do this
  438.         fiddlewithA5 = IsRelativeProcessSerialNumber(&targetpsn);
  439.         if (fiddlewithA5) 
  440.             saveA5 = SetCurrentA5();
  441.         if (((errnum = AECreateDesc(typeProcessSerialNumber, &targetpsn, sizeof(targetpsn), &targetaddress)) == noErr) && 
  442.             ((errnum = AECreateAppleEvent(kAEFinderSuite, kAEUpdate, &targetaddress, kAutoGenerateReturnID, kAnyTransactionID, &myae)) == noErr) && 
  443.             ((errnum = AEDisposeDesc(&targetaddress)) == noErr) && 
  444.             ((errnum = AECreateDesc(typeFSS, f, sizeof(FSSpec), &updatedesc)) == noErr) && 
  445.             ((errnum = AEPutParamDesc(&myae, keyDirectObject, &updatedesc)) == noErr) && 
  446.             ((errnum = AEDisposeDesc(&updatedesc)) == noErr) && 
  447.             ((errnum = AESend(&myae, &myreply, sendmode, kAENeverInteract, kAEDefaultTimeout, nil, nil)) == noErr) && 
  448.             ((errnum = AEDisposeDesc(&myreply)) == noErr)) 
  449.             errnum = AEDisposeDesc(&myae);
  450.         if (fiddlewithA5) 
  451.             SetA5(saveA5);            // fix it up for crying out loud!
  452.         if (usesystemmode) 
  453.             TurnSystemModeOff();            // we really DIDN'T want to do this
  454.     }
  455.     return(errnum);            // the result
  456. }
  457.  
  458. static    pascal    OSErr    addIconsToAERecord (ResType theType, Handle *theIcon, void *yourDataPtr)
  459.  
  460. {
  461.     return(AEPutKeyPtr((AERecord*)yourDataPtr, theType, theType, **theIcon, GetHandleSize(*theIcon)));
  462. }
  463.  
  464. OSErr    SetScriptableFinderFileIcon (FSSpec *f, Handle iconFamily, Boolean usesystemmode, 
  465.                                         AESendMode sendmode)
  466.  
  467. /*    
  468.  
  469.      Input:    f - FSSpec which contains the item to change the custom icon of.
  470.      Input:    usesystemmode - a Boolean which determines whether the system's PPC port will be used.
  471.      Input: sendmode - which mode to send the Apple Event to the Finder.
  472.  
  473.     Output:    error code that occured. */
  474.  
  475. {
  476.     short                errnum;
  477.     OSType                icondescriptor;
  478.     ProcessSerialNumber    targetpsn;
  479.     AEDesc                targetaddress, propdesc, filedesc, directdesc, icondesc, nulldesc, targetdesc;
  480.     AppleEvent            myae;
  481.  
  482.     nulldesc.descriptorType = typeNull;
  483.     nulldesc.dataHandle = nil;
  484.  
  485.     icondescriptor = pIconBitmap;
  486.     if (GetFinderProcess(&targetpsn, kAbsoluteFinderPSN) == noErr) 
  487.     {
  488.         if (usesystemmode)     TurnSystemModeOn();            // you really DON'T want to do this
  489.         
  490.         // create the icon family descriptor
  491.         {
  492.             OSErr    err;
  493.             
  494.             if ((err = AECreateList(nil, 0, true, &icondesc)) == noErr) {
  495.                 err = ForEachIconDo(iconFamily, svAllAvailableData, addIconsToAERecord, (void *)&icondesc);
  496.                 err = AECoerceDesc(&icondesc, cIconFamily, &icondesc);
  497.             }
  498.         }
  499.         
  500.         if ((errnum = AECreateDesc(typeProcessSerialNumber, &targetpsn, sizeof(targetpsn), &targetaddress)) == noErr) {
  501.             if ((errnum = AECreateAppleEvent(kAECoreSuite, kAESetData, &targetaddress, kAutoGenerateReturnID, kAnyTransactionID, &myae)) == noErr) {
  502.                 if ((errnum = AECreateDesc(typeType, &icondescriptor, sizeof(DescType), &propdesc)) == noErr) {
  503.                     AliasHandle    targetAlias;
  504.                     NewAlias(nil, f, &targetAlias);
  505.                     HLock((Handle)targetAlias);
  506.                     if ((errnum = AECreateDesc(typeAlias, *targetAlias, GetHandleSize((Handle)targetAlias), &filedesc)) == noErr) {
  507.                         if ((errnum = CreateObjSpecifier(typeWildCard, &nulldesc, typeAlias,&filedesc, TRUE, &targetdesc)) == noErr) {
  508.                             if ((errnum = CreateObjSpecifier(cProperty, &targetdesc, formPropertyID, &propdesc, TRUE, &directdesc)) == noErr) {
  509.                                 if ((errnum = AEPutParamDesc(&myae, keyDirectObject, &directdesc)) == noErr) {
  510.                                     if ((errnum = AEPutParamDesc(&myae, keyAEData, &icondesc)) == noErr) {
  511.                                         errnum = AESend(&myae, nil, sendmode, kAENeverInteract, kAEDefaultTimeout, nil, nil);
  512.                                     }
  513.                                 }
  514.                                 AEDisposeDesc(&directdesc);
  515.                             }
  516.                         }
  517.                         AEDisposeDesc(&filedesc);
  518.                     }
  519.                     HUnlock((Handle)targetAlias);
  520.                     AEDisposeDesc(&propdesc);
  521.                 }
  522.                 AEDisposeDesc(&myae);
  523.             }
  524.             AEDisposeDesc(&targetaddress);
  525.         }
  526.         
  527.         AEDisposeDesc(&icondesc);
  528.         
  529.         if (usesystemmode)     TurnSystemModeOff();            // we really DIDN'T want to do this
  530.     }
  531.     return(errnum);            // the result
  532. }
  533.  
  534. OSErr    GetScriptableFinderFileIcon (FSSpec *f, Boolean usesystemmode, AESendMode sendmode, Handle *iconFamily)
  535.  
  536. /*    
  537.  
  538.      Input:    f - FSSpec which contains the item to change the custom icon of.
  539.      Input:    usesystemmode - a Boolean which determines whether the system's PPC port will be used.
  540.      Input: sendmode - which mode to send the Apple Event to the Finder.
  541.  
  542.     Output:    error code that occured. */
  543.  
  544. {
  545.     short                errnum;
  546.     OSType                icondescriptor;
  547.     ProcessSerialNumber    targetpsn;
  548.     AEDesc                targetaddress, propdesc, filedesc, directdesc, icondesc, nulldesc, targetdesc;
  549.     AppleEvent            myae, myreply;
  550.  
  551.     nulldesc.descriptorType = typeNull;
  552.     nulldesc.dataHandle = nil;
  553.  
  554.     icondescriptor = pIconBitmap;
  555.     if (GetFinderProcess(&targetpsn, kAbsoluteFinderPSN) == noErr) 
  556.     {
  557.         if (usesystemmode)     TurnSystemModeOn();            // you really DON'T want to do this
  558.         
  559.         if ((errnum = AECreateDesc(typeProcessSerialNumber, &targetpsn, sizeof(targetpsn), &targetaddress)) == noErr) {
  560.             if ((errnum = AECreateAppleEvent(kAECoreSuite, kAEGetData, &targetaddress, kAutoGenerateReturnID, kAnyTransactionID, &myae)) == noErr) {
  561.                 if ((errnum = AECreateDesc(typeType, &icondescriptor, sizeof(DescType), &propdesc)) == noErr) {
  562.                     AliasHandle    targetAlias;
  563.                     NewAlias(nil, f, &targetAlias);
  564.                     HLock((Handle)targetAlias);
  565.                     if ((errnum = AECreateDesc(typeAlias, *targetAlias, GetHandleSize((Handle)targetAlias), &filedesc)) == noErr) {
  566.                         if ((errnum = CreateObjSpecifier(typeWildCard, &nulldesc, typeAlias,&filedesc, TRUE, &targetdesc)) == noErr) {
  567.                             if ((errnum = CreateObjSpecifier(cProperty, &targetdesc, formPropertyID, &propdesc, TRUE, &directdesc)) == noErr) {
  568.                                 if ((errnum = AEPutParamDesc(&myae, keyDirectObject, &directdesc)) == noErr) {
  569.                                     errnum = AESend(&myae, &myreply, sendmode, kAENeverInteract, kAEDefaultTimeout, nil, nil);
  570.                                     if (errnum == noErr) {
  571.                                         if (((errnum = AEGetParamDesc(&myreply, keyAEResult, typeWildCard, &icondesc)) == noErr)) {
  572.                                             errnum = AECoerceDesc(&icondesc, typeAERecord, &icondesc);
  573.                                             
  574.                                             {    // copy all the records into our iconfamily
  575.                                                 OSErr        err;
  576.                                                 long        i, numItems;
  577.                                                 AEKeyword    keyWord;
  578.                                                 DescType    theType;
  579.                                                 Size        theSize;
  580.                                                 
  581.                                                 if (!NewIconSuite(iconFamily)) {
  582.                                                     if (!(err = AECountItems(&icondesc, &numItems))) {
  583.                                                         for (i = 1; i <= numItems; i++) {            
  584.                                                             if (!(err = AEGetNthPtr(&icondesc,i,typeWildCard,&keyWord,&theType,
  585.                                                                                     nil,0L,&theSize))) {
  586.                                                                 Handle    buffer = NewHandle(theSize);
  587.                                                                 HLock(buffer);
  588.                                                                 if (!(err = AEGetNthPtr(&icondesc,i,typeWildCard,&keyWord,&theType,
  589.                                                                                         *buffer,GetHandleSize(buffer),&theSize))) {
  590.                                                                     AddIconToSuite(buffer, *iconFamily, keyWord);
  591.                                                                 }
  592.                                                                 // DisposeHandle(buffer);
  593.                                                             }
  594.                                                         }
  595.                                                     }
  596.                                                 }
  597.                                                 
  598.                                             }    
  599.  
  600.                                             AEDisposeDesc(&icondesc);
  601.                                         }
  602.                                     }
  603.                                 }
  604.                                 AEDisposeDesc(&directdesc);
  605.                             }
  606.                         }
  607.                         AEDisposeDesc(&filedesc);
  608.                     }
  609.                     HUnlock((Handle)targetAlias);
  610.                     AEDisposeDesc(&propdesc);
  611.                 }
  612.                 AEDisposeDesc(&myae);
  613.             }
  614.             AEDisposeDesc(&targetaddress);
  615.         }
  616.         
  617.         if (usesystemmode)     TurnSystemModeOff();            // we really DIDN'T want to do this
  618.     }
  619.     return(errnum);            // the result
  620. }
  621.  
  622.  
  623. OSErr    GetScriptableFinderFileLocation (FSSpec *f, Boolean usesystemmode, AESendMode sendmode, 
  624.                                          Boolean sendToSelf, Rect *r)
  625.  
  626. /*    
  627.  
  628.      Input:    f - FSSpec which contains the item to the position of.
  629.      Input:    usesystemmode - a Boolean which determines whether the system's PPC port will be used.
  630.      Input: sendmode - which mode to send the Apple Event to the Finder.
  631.  
  632.     Output:    error code that occured. */
  633.  
  634. {
  635.     short                errnum;
  636.     OSType                icondescriptor, finderSig = 'MACS';
  637.     ProcessSerialNumber    targetpsn;
  638.     AEDesc                targetaddress, propdesc, filedesc, directdesc, nulldesc, targetdesc, pointdesc;
  639.     AppleEvent            myae, myReply;
  640.     Rect                rect;
  641.     Boolean                fiddlewithA5;            // See below for the usage of the A5 variables
  642.     long                saveA5;
  643.  
  644.  
  645.     nulldesc.descriptorType = typeNull;
  646.     nulldesc.dataHandle = nil;
  647.  
  648.     icondescriptor = pBounds;
  649.     if (GetFinderProcess(&targetpsn, sendToSelf) == noErr) 
  650.     {
  651.         if (usesystemmode)     TurnSystemModeOn();            // you really DON'T want to do this
  652.         fiddlewithA5 = IsRelativeProcessSerialNumber(&targetpsn);
  653.         if (fiddlewithA5)     saveA5 = SetCurrentA5();
  654.         
  655.         if ((errnum = AECreateDesc(typeProcessSerialNumber, &targetpsn, sizeof(ProcessSerialNumber), &targetaddress)) == noErr) {
  656.             if ((errnum = AECreateAppleEvent(kAECoreSuite, kAEGetData, &targetaddress, kAutoGenerateReturnID, kAnyTransactionID, &myae)) == noErr) {
  657.                 if ((errnum = AECreateDesc(typeType, &icondescriptor, sizeof(DescType), &propdesc)) == noErr) {
  658.                     AliasHandle    targetAlias;
  659.                     NewAlias(nil, f, &targetAlias);
  660.                     HLock((Handle)targetAlias);
  661.                     if ((errnum = AECreateDesc(typeAlias, *targetAlias, GetHandleSize((Handle)targetAlias), &filedesc)) == noErr) {
  662.                         if ((errnum = CreateObjSpecifier(typeWildCard, &nulldesc, typeAlias,&filedesc, TRUE, &targetdesc)) == noErr) {
  663.                             if ((errnum = CreateObjSpecifier(cProperty, &targetdesc, formPropertyID, &propdesc, TRUE, &directdesc)) == noErr) {
  664.                                 if ((errnum = AEPutParamDesc(&myae, keyDirectObject, &directdesc)) == noErr) {
  665.                                     errnum = AESend(&myae, &myReply, sendmode, kAENeverInteract, kAEDefaultTimeout, nil, nil);
  666.                                     if ( errnum == noErr) {
  667.                                         // Get Rect
  668.                                         if (((errnum = AEGetParamDesc(&myReply, keyAEResult, cQDRectangle, &pointdesc)) == noErr))
  669.                                             rect = **((Rect **)(pointdesc.dataHandle));
  670.                                     }
  671.                                 }
  672.                                 
  673.                                 AEDisposeDesc(&directdesc);
  674.                             }
  675.                         }
  676.                         AEDisposeDesc(&filedesc);
  677.                     }
  678.                     HUnlock((Handle)targetAlias);
  679.                     AEDisposeDesc(&propdesc);
  680.                 }
  681.                 AEDisposeDesc(&myae);
  682.             }
  683.             AEDisposeDesc(&targetaddress);
  684.         }
  685.         
  686.         // Get Rect
  687.         *r = rect;
  688.         
  689.         if (fiddlewithA5)     SetA5(saveA5);            // fix it up for crying out loud!
  690.         if (usesystemmode)     TurnSystemModeOff();            // we really DIDN'T want to do this
  691.     }
  692.     return(errnum);            // the result
  693. }
  694.  
  695. OSErr    GetScriptableFinderTrashLocation (Boolean usesystemmode, AESendMode sendmode, Boolean sendToSelf, Rect *r)
  696.  
  697. /*    
  698.  
  699.      Input:    f - FSSpec which contains the item to the position of.
  700.      Input:    usesystemmode - a Boolean which determines whether the system's PPC port will be used.
  701.      Input: sendmode - which mode to send the Apple Event to the Finder.
  702.  
  703.     Output:    error code that occured. */
  704.  
  705. {
  706.     short                errnum;
  707.     OSType                icondescriptor, trshdescriptor, finderSig = 'MACS';
  708.     ProcessSerialNumber    targetpsn;
  709.     AEDesc                targetaddress, propdesc, trshpropdesc, filedesc, directdesc, nulldesc, targetdesc, pointdesc;
  710.     AppleEvent            myae, myReply;
  711.     Rect                rect;
  712.     Boolean                fiddlewithA5;            // See below for the usage of the A5 variables
  713.     long                saveA5;
  714.  
  715.  
  716.     nulldesc.descriptorType = typeNull;
  717.     nulldesc.dataHandle = nil;
  718.  
  719.     icondescriptor = pBounds;
  720.     trshdescriptor = 'trsh';
  721.     if (GetFinderProcess(&targetpsn, sendToSelf) == noErr) 
  722.     {
  723.         if (usesystemmode)     TurnSystemModeOn();            // you really DON'T want to do this
  724.         fiddlewithA5 = IsRelativeProcessSerialNumber(&targetpsn);
  725.         if (fiddlewithA5)     saveA5 = SetCurrentA5();
  726.         
  727.         if ((errnum = AECreateDesc(typeProcessSerialNumber, &targetpsn, sizeof(ProcessSerialNumber), &targetaddress)) == noErr) {
  728.             if ((errnum = AECreateAppleEvent(kAECoreSuite, kAEGetData, &targetaddress, kAutoGenerateReturnID, kAnyTransactionID, &myae)) == noErr) {
  729.                 if ((errnum = AECreateDesc(typeType, &icondescriptor, sizeof(DescType), &propdesc)) == noErr) {
  730.                     if ((errnum = AECreateDesc(typeType, &trshdescriptor, sizeof(DescType), &trshpropdesc)) == noErr) {
  731.                         if ((errnum = CreateObjSpecifier(cProperty, &nulldesc, formPropertyID, &trshpropdesc, TRUE, &targetdesc)) == noErr) {
  732.                             if ((errnum = CreateObjSpecifier(cProperty, &targetdesc, formPropertyID, &propdesc, TRUE, &directdesc)) == noErr) {
  733.                                 if ((errnum = AEPutParamDesc(&myae, keyDirectObject, &directdesc)) == noErr) {
  734.                                     errnum = AESend(&myae, &myReply, sendmode, kAENeverInteract, kAEDefaultTimeout, nil, nil);
  735.                                     if ( errnum == noErr) {
  736.                                         // Get Rect
  737.                                         if (((errnum = AEGetParamDesc(&myReply, keyAEResult, cQDRectangle, &pointdesc)) == noErr))
  738.                                             rect = **((Rect **)(pointdesc.dataHandle));
  739.                                     }
  740.                                 }
  741.                                 
  742.                                 if (directdesc.dataHandle)    AEDisposeDesc(&directdesc);
  743.                             }
  744.                         }
  745.                         if (directdesc.dataHandle)    AEDisposeDesc(&trshpropdesc);
  746.                     }
  747.                     if (directdesc.dataHandle)    AEDisposeDesc(&propdesc);
  748.                 }
  749.                 if (directdesc.dataHandle)    AEDisposeDesc(&myae);
  750.             }
  751.             if (directdesc.dataHandle)    AEDisposeDesc(&targetaddress);
  752.         }
  753.         
  754.         // Get Rect
  755.         *r = rect;
  756.         
  757.         if (fiddlewithA5)     SetA5(saveA5);            // fix it up for crying out loud!
  758.         if (usesystemmode)     TurnSystemModeOff();            // we really DIDN'T want to do this
  759.     }
  760.     return(errnum);            // the result
  761. }